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CHAPTER 1 
INTRODUCTION 

TSS/8 (Time-Sharing System for the PDP-8/1 Computer) is a general purpose stand-alone/ 
time-sharing system offering each of up to 32 users a comprehensive library of system, utility, and 

service programs which provide facilities for compiling, assembling, editing, loading, saving, calling, 

1 2 

and debugging user programs on-line, and also two conversational languages, FOCAL and BASIC-8 . 

The minimum hardware configuration is designed for eight users and includes the following: 
a modified PDP-8/1 or PDP-8 with 8K words of core memory, a RF08 Disk, a PT8/I high-speed paper 
tape reader, and Teletype control units for data communication (either four PTOBs or one 680/1 per 
system). See Section 1.6 for a complete list of possible optional devices and for the configuration for 
systems accommodating up to 32 users. 

By segregating the central processing operations from the time-consuming interactions with 
the human users, the computer can in effect work on a number of programs simultaneously. Giving 
only a fraction of a second at a time to each program or task, the computer can deal with many users 
seemingly at once, as if each had the computer to himself. The execution of various programs are 
interspersed without interfering with one another and without detectable delays in the responses to the 
individual users. 

1.1 MONITOR FUNCTIONS 

The heart of this time-sharing system is a complex of subprograms called Monitor. Monitor 
coordinates the operations of the various units, allocates the time and services of the computer to users 
and controls their access to the system. The allocation function includes scheduling the user's requests, 
transferring control of the central processor from one user to another, moving (swapping) programs in 
and out of core memory, and managing the user's private files. 

1.2 TSS/8 USER AND CONSOLE 

A TSS/8 user is any person running a computer program within TSS/8. He has an account 
number assigned to him by the person responsible for the system which determines his identity for TSS/8 
and identifies his files on a permanent basis. When he is using the system this number also identifies 



1 FOCAL (FOrmula CALculator) is an on-line conversational interpretive program developed 
by Digital Equipment Corporation. 

2 BASIC-8 is a modified version of the elementary algebraic language developed at 
Dartmouth College. 
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his console, his individual disk swapping track (a contiguous 4K section of disk) for temporary storage 
of active programs, and whatever other facilities he may be using at any given time. 

While the user is logged into the system, he owns at least one console (Figure 1-1) and one 
4K disk track. The console consists of a keyboard (Figure 1-2), which allows the user to type infor- 
mation to his user programs and Monitor, and an output device, usually a Teletype printer, which fur- 
nishes typed copy of program and Monitor output and user input. 
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Figure 1-1 User Console 
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Figure 1-2 Users Console Keyboard 
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1.3 SYSTEM PROGRAM UBRARY 

A comprehensive library of programs is available to all TSS/8 users. The library provides 
facilities for assembling, compiling, editing, and debugging user programs. Any of the system, utility, 
and service programs can be called into use by typing, in response to the dot typed by Monitor, the 
command R and the assigned name of the programs. For example, 

.R FOCAL 
brings FOCAL into core from the disk and automatically executes FOCAL so that it begins typing out 
its Initial Dialogue. 

The System Program Library contains the following programs: 

a. Binary (BIN) Loader - used to load user programs into core memory from the console. 

b. Symbolic Tape Editor - used to prepare, edit, and generate symbolic (source) programs 
and program tapes from the console. 

c. PAL III Symbolic Assembler - used to translate source programs written in the PAL III 
language into object programs. 

d. MACRO-8 Assembler - used to translate source programs written in the MACRO-8 
language, containing macros and literals, into object programs. 

e. Dynamic Debugging Technique (DDT-8) - used to aid the user in correcting errors in 
stored user programs by allowing him to execute small sections at a time, to stop execution where he 
wishes, and to change portions of his program, using the symbolic language of the source program or 
machine language. The user may create an octal program using the DEPOSIT command. 

f. Octal Debugging Technique (ODT-8) - used for the same purpose as DDT-8 (above) 
except that the user communicates in the octal representation of his program. ODT-8 requires less 
core area than DDT-8, and can be loaded in either the upper or lower portion of core, depending 
upon where the user's program is loaded. 

g. FORTRAN (4K) - used to compile and operate a user program written in the 4K version 
of the FORTRAN language; compilation requires only one pass through the compiler. 

h. FOCAL (FOrmula CALculator) - anon-line, conversational, interpretive program used to 
solve complex numerical problems; used as a programming tool by students, engineers, and scientists. 

'• BASIC-8 - an elementary algebraic language, is an on-line, service program similar 
to FOCAL used to solve complex numerical problems. 

1.4 USER PROGRAMS 

A user program is any program being run in user mode by TSS/8. When a user program is 
being run by TSS/8 it is swapped into core memory from the user's disk track. Several programs may 
be run by a regular process of bringing a program into core from the disk, allowing it to execute for a 
short time, marking the state in which its execution is stopped, returning it to the disk, and picking up 
the next user program. 
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User programs are serviced regularly on a "round-robin" basis. After a user program has been 
executed, it is placed last in the order of user programs waiting to run. Each program is allowed to run 
one quantum of time and then it is exchanged for the next user program. If only one program is in a 
condition to run, it is allowed to run without interruption. 

There are three ways in which a user can place a binary program on his disk track. 

a. He may prepare an octal program at a console using a debugging program such as DDT-8, 

b. He may load a previously saved core Image, or 

c. He may load the binary output file of a previous assembly or compilation. 

1.5 USER HLES 

Disk storage is divided into logical areas called files. Facilities are available for creating 
new files and extending, contracting, and destroying old files. Files may contain textual information, 
binary core images, or data in any standard format. The user can also protect his files against unau- 
thorized access. 

A user file directory (see Appendix E) is assigned to each user by the person responsible for 

the system before the user first logs into the system. The user file directory is associated with the job 

number assigned to the user by the Monitor each time the user logs in. 

Files are composed of segments of disk storage. A segment can consist of from 200- to 

o 

2000q words. Files are at least one segment long and grow by adding additional segments to the end 
o 

of the file. 

Each user may have access to up to four active files at any time. An internal file number, 
O through 3, is associated with each of the user's active files, and commands then operate in terms of 
the internal file numbers. With this feature, a user may attach one of his files to an internal file num- 
ber and then load system and utility programs which operate on his file without having to explicitly 
call the file for each system or utility program used. 

1.6 SYSTEM CONRGURATION 



Depending upon the hardware configuration of a particular TSS/8, there can be from 1 to 
32 users working with the system simultaneously. Each user has, in addition to system software, the 
following resources: at least 4K words of core memory for execution of programs, and a corresponding 
4K disk track for temporary storage of his core image. 
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1.6.1 Minimum Hardware Requirements 

The minimum equipment requirements of the system are listed below (see Figure 1-3). 

PDP-8/I or PDP-8 with KT08/I Time-Sharing Modifications 

MCB/I-A Memory Extension Control and 4096 words 

RF08 Disk Control 

RS08 Disk 

PT08 Asynchronous Line Interfaces, Dual (4) 

PT8/I High-Speed Paper Tape Reader 

KE8/I Automatic Multiply-Divider 

CAB 8/IA Option Cabinet 



(TELETYPE MODEL 
33 OR 35) 



C 
L 

C 
K 



CONSOLES 
(1 TO 32) 




CONSOLE CONTROL 
680/1 OR PTOS'S 



CPU 



( RF08 j 



(TELETYPE MODEL 
33 OR 35) 



4K CORE 



EXTRA 
4K CORE 



1.6.2 Hardware Options 



Figure 1-3 System Configuration 



The system can have a maximum of 32K of core memory. As additional fields of core mem- 
ory are added they permit overlapping the running time of one user program with the swapping time of 
another, expanding the resident Monitor to buffer a larger number of consoles, and reducing the amount 
of Monitor overlay required. 

With a minimum of 12K of core memory, the following options are available. 

a. Up to three DECdisks can be appended to increase the number of active users and their 



file storage. 



b. Up to eight DECtapes can be appended for the use of private DECtapes by users. 
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c. Memory Parity 

d. Extended Aril-hmeHc Element- (PDP-8/I only) 

e. Power Failure 

f. 1 High-Speed Paper Tape Punch 

g. 1 Card Reader 

h. 1 Incremental Plotter 

i. 1 Line Printer 

i. 1 DAI Interface (PDP-10) 

k. 1 Bit Synchronous Communication Unit (Type 637) 

I. 1 Line Frequency Clock (required with PTOS's) 

m. 32 Teletype Controls (PTOS's or 680/1) 

1.6.3 Data Communication System, Type 680/1 

The Data Communication System, Type 680/1, is used in full duplex mode. It consists of a 
Data Line Interface Unit (DL8/I), a Serial Line Multiplexer Unit (685), and other devices connected 
to form a data link and message switching system between the user consoles and the central processor. 
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CHAPTER 2 
THE TSS/8 MONITOR 



2.1 MONITOR SERVICES 



The TSS/8 Monitor is composed of the following routines: 

lOT Trap Handler Error Message Handler 

Scheduler Buffer Handler 

Storage Allocator 680 Service 

Overlay Control Disk Service 

System Interpreter Optional Device Service 

File Control 
With the above routines. Monitor provides services which may be divided into three broad categories: 

a. Device Service 

b. Scheduling and Activation 

c. Communication 

On an interrupt basis the Device Service routines receive information from all input devices, 
parcel that information out to the appropriate buffers, and inform the Activation routine when a user 
program must be activated to receive its information. The Device Service routines accept output from 
user programs, buffer it, and send it to output devices whenever they are able to receive it. 

Activation is handled by a "round-robin" scheduling algorithm with the exception that pro- 
grams with disk requests pending are run out of turn to optimize disk usage. The Activation routine 
decides whether to remove the current program from core, and if so, which program is to be run next. 

A user program is, at any point in time, in one of the following states. 

a. Running - The user program is in execution. It continues execution until its quantum 
has expired or until it issues an input/output (I/O) request that cannot be satisfied immediately. 

b. Active - The user program is ready to run and will be swapped into core when its turn 
comes. A program can become active when 

(1) An output buffer is almost empty, thus assuring continuous output of information, 

(2) An input buffer is almost full, 

(3) Input requested by a user has arrived, 

(4) A user determined activation condition has been satisfied, or 

(5) When the user commands the system to begin execution. 

c. Waiting - In this state, the program would be active except that it is waiting for the 
completion of some I/O request or special condition. 

d. Dormant - The program is not being entered into the "round-robin. " The user may be 
communicating with Monitor or the program may be dismissed for a variety of user determined reasons. 
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A program may be swapped ouf of core memory for any of the following reasons. 

a. The quantum has expired; the program moves from the running state to the active state. 

b. The program has requested the quantum be terminated; the program moves from the 
running state to the active state. 

c. The program has filled an output buffer, has requested input and the input buffer is 
empty, or has requested a special dismissal condition; the program moves from the running state to 
the waiting state. 

d. The program has tried to execute an illegal instruction; the program moves from the 
running state to the dormant state. 

Monitor checks all incoming characters for the call (CTRL/B) character. When the call 

character is encountered. Monitor routes all subsequent characters up to and including the first carriage 

return (CR) to its System Interpreter's input buffer. Monitor's System Interpreter routine performs the 

following services. 

a. Verifies the user's name and account number when he logs in and provides him with a 
disk track to store user programs. It releases facilities owned by the user when he logs out. 

b. Parcels out extra consoles and input/output devices. 

c. Provides commands for creating, opening, and maintaining the user's files. 

d. Allows the user to save all or part of his binary user program for future use and reference, 
and restores it with its state unchanged. 

e. Provides accounting of console time and user program run time. 

f. Provides the user with information about the state of his program while running, as well 
as information about the state of the character control tables. 

g. Provides commands for calling the various utility programs. 

Communications to the System Interpreter are automatically duplexed. That is, all characters 
from a keyboard to the System Interpreter appear on that console's printer, regardless of the switchboard 
setting. (See Section 2.3.) 

The System Interpreter may be receiving messages from many keyboards and user programs, 
therefore, it must be run often. Consequently, it occupies its private position in the "round-robin, " 
being activated whenever there are characters in its input buffer. 

Monitor has two Phantom routines: Error and File Control. Phantoms are privileged routines 
which run in place of a regular user program in the "round-robin. " The time the Phantom takes to 
perform its service is charged to that user program upon which it is servicing. 

The Error Phantom prints all error messages for running user programs. Printing a lengthy 
error message may require several quanta; the use of the Error Phantom punishes the user responsible 
for the error and no one else. 

The File Control Phantom handles such modifications to the file directory as creating, 
lengthening, renaming, and destroying files. This Phantom is brought into operation when a user pro- 
gram executes certain lOT instructions or when Monitor is acting for the user program. 
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CHARACTER AND DATA FLOW 



When a user logs into the system his account number is associated with a job number, and 
that job number is then associated with a disk swapping track and the console(s) he owns. The account 
number establishes ownership of the input buffer attached to the user program on his disk track and the 
output buffers attached to the printers of his consoles. 

Monitor provides for communication among the users, user programs, and Monitor. Data 
communication is illustrated in Figure 2-1. Communication is provided through the lOT instructions. 
When a program executes certain lOT instructions. Monitor picks up locations in the user program as 
parameters to service routines. These routines may simulate input/output to the on-line device, control 
or release ownership of devices, handle character communication, or return information to the user 
program by filling registers within the program. Through lOT instructions, the user program can make 
its wants known and Monitor can inform the user program of any variation in the time-sharing system. 
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Figure 2-1 Character and Data Flow 
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2.2.1 Character Transmission 

The input/output transfer instructions provide character transmission. Characters are gener- 
ated by users typing at keyboards or by user programs typing out. Characters go into input buffers to be 
read by user programs or to output buffers to be printed on Teletype printers. A switchboard device sets 
up useful character transmission paths, whereby any character source (keyboard and program) may, with 
permission, send to any character sink (input and output buffer). To insure that unwanted connections 
are not made, using the appropriate command to Monitor the user owning any character sink may grant 
or deny permission for connection into that sink. 

A console may be thought of as two disassociated devices, a keyboard and a printer. To each 
printer there is an associated character output buffer numbered like the consoles, O-K. When a char- 
acter is placed into output buffer number n. Monitor causes that character to be printed on printer 
number n. 

Each job has an associated character input buffer numbered like the job, O-P. When user 
program number n executes a keyboard input lOT, the next character waiting in input buffer number 
n is placed in the user program's accumulator (AC). This character may be a data character, 
the source of the last data character, or the time that the last data character was placed in the 
input buffer. 

2.2.2 General Input Routine 



The General Input Routine (GIR) provides and controls character input to user programs. 
Programs vary in how promptly they must pay attention to incoming characters. In the preparation of 
a file, characters are added to the input buffer when typed; when the input buffer gets full the program 
receives all the characters at once and transmits them to the disk. In this case, the user's program 
is activated only when the input buffer gets full. With a program whose operation is controlled from 
the keyboard, however, every character typed goes directly to and influences the program's action. 

Through lOTs, the user program can specify under which conditions the input characters 
will cause the program to be activated. These conditions are called delimiters. A delimiter may be 
some specific type of character appearing in the input or it may be a change in the source of characters; 
the input buffer becoming full is always a delimiter. 

GIR places all incoming characters in the user's input buffer until a delimiter is encountered. 
When a delimiter appears, the user program is always alerted and usually activated to receive all the 
characters in the input buffer. This is done by setting the delimiter bit (status register 1) to one. If 
the Wait Mask (see Chapter 4, Set Wait Mask) is set to one, the user program will be activated. 
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PERMISSION AND SWITCHBOARD TABLES 



Characters originating from any keyboard or from any user program typing out can, with 
permission, be placed in any or all of the K output buffers or any or all of the P input buffers. The 
Permission Table is the device with which a user controls which character sources may place characters 
in which of his buffers; the Switchboard Table controls the actual routing of these characters. 

The Permission and Switchboard Tables are organized as matrices (see Figures 2-2 and 2-3). 
The rows represent character sources, that is, keyboards and programs typing out. The columns represent 
character sinks, that is, input and output buffers. Along the rows are the K keyboards and P programs. 
Along the columns are the P input buffers and the K output buffers. 
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Figure 2-2 Permission Table 
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Figure 2-3 Switchboard Table 
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2.3.1 Permission Table 



The Permission Table acts as the matrix of permitted connections. For example, if the bit R, 
Y is a one, it means that the owner of input buffer number Y allows keyboard number R to place char- 
acters in it. Similarly, if bit S,Z is a one, it means that the owner of output buffer number Z (printer 
Z) has agreed to allow job number S to type out characters onto printer Z. In general, if a bit in the 
Permission Table is a one, the owner of the entity specified by the column has granted permission for 
the entity specified by the row to place characters in his sink. 

The fact that permission for a given character routing has been established does not neces- 
sarily mean that characters automatically flow along that route. A route to a buffer is not established 
unless the owner of the keyboard or program sets the Switchboard Table. 

2.3.2 Switchboard Table 

The Switchboard Table acts as a matrix of requests by the owner of a character source that 
characters emitted by that source appear in some sink. If bit Q,W is a one, characters coming from 
program number Q typing out will appear in input buffer number W, Similarly, if bit P,X is a one, 
characters typed on keyboard number P will appear in the output buffer of printer number X. In general, 
if a bit in the Switchboard Table is a one, characters emitted by the source specified by the row will 
appear in the sink specified by the column. Attempts to set bits in the Switchboard Table are automati- 
cally checked against the Permission Table. Only if the corresponding bit in the Permission Table is a 
one will the system allow that bit to be set in the Switchboard Table. The Switchboard Table may be 
regarded as the final arbiter of character routing. 

Bits in the Permission and Switchboard Tables may be set, reset, and read by using Monitor 
commands or by an lOT instruction which the system executes interpretively. 

The Permission and Switchboard Tables are automatically set up for normal use when a user 
logs into the system. This configuration is: 

a. The user gives permission for his keyboard to send characters to his user program's input 
buffer. 

b. The user gives permission for his keyboard to send characters to his printer's output 
buffer (this condition is known as duplexing). Whether the characters actually appear depends upon 
the corresponding Switchboard setting. Normally, the Switchboard is not set to handle the input be- 
fore it is printed. 

c. The user gives permission for his program to type characters to its own input buffer. 
(The Switchboard determines whether characters typed out will in fact be sent to the input buffer.) 

d. The user gives permission for his program to send characters to his printer's output buffer. 
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e. The Switchboard is set so that characters from the user's keyboard will be placed in the 
user program's input buffer. 

f. The Switchboard is set so that characters typed out by the user program will be placed 
in the program's output buffer. 

The user is, of course, free to modify and add to these settings. 

The Switchboard generality finds application in: 

a. Duplexing - Characters typed at a keyboard can be printed on any console without user 
program intervention. 

b. Interprogram Communication - User programs can communicate with each other and 
with Monitor. Thus, several user programs may run as one system coordinating their separate tasks 
through character communication. 

c. Interconsole Communication - Users at consoles can set up general links for conferences, 
teaching, monitoring, or for any other reason. 

d. Multiple Consoles - User programs may receive characters from and send characters to 
more than one console. This allows a user program to act as a time-sharing system within TSS/8, con- 
trolling its own set of consoles, as in teaching machine monitors. 
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CHAPTER 3 
MONITOR COMMANDS 

A Monitor command is a string of characters terminated by a semicolon (;) or a carriage 

return (RETURN key). Commands to Monitor are typed on the Teletype keyboard by the user or output 

by the user program, with each command beginning with a command name. In some cases, the command 

name is the entire command, in which case it is followed directly by a terminator. In other cases, the 

command name is followed by a space, one or more parameters, and then a terminator. For example, 

.TIME (requesting the time of day. This command was terminated by the 

RETURN key) 

.TIME CI (requesting the processing time used by job CI . Terminated by the 

RETURN key) 

Only enough characters need be typed in the command name to uniquely identify the command name. 

For example, 

LOGI for LOGIN 

LOGO for LOGOUT 

More than one command may be typed on a line, with all but the last command being ter- 
minated by a semicolon; the last command is terminated by the RETURN key. For example, 

.OPEN CI SI C2; LOAD CI SI; START CI 
(The abbreviated parameters are explained below.) 

NOTE 

Commands are executed when the RETURN key is typed, 
which explains why the last command on a line must be 
terminated by the RETURN key. 

As shown in the above examples, each command or line of commands is typed after the dot 
typed by Monitor. The dot is typed by Monitor when it is ready and available to accept commands 
from the user. 

Parameters may be typed as octal numbers, decimal numbers, character strings, or single 
letters. In the following descriptions of Monitor commands the parameters are coded as follows. 

CI, C2, ... represent octal numbers 

Dl, D2, ... represent decimal numbers 

SI, S2, ... represent character strings 

LI, L2, ... represent single letters 
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3.1 



LOGGING IN AND OUT 



Logging in and out- of TSS/8 is a function performed by Monitor's System Interpreter routine. 
When a console is in the free state, a prospective user may attempt to log into the system. 



LOGIN CI SI; 



LOGOUT; 



TIME CI; 



This is a request by a user to log into the system. If the console from 
which the command is typed is free, there is an available disk track, 
and the two parameters following the command LOGIN form a legiti- 
mate account number and password, then the user will be logged into 
the system. 

CI is the user's account number 
SI is the user's password 

At the time of login, the Switchboard is initialized to the normal 
operation setting. However, Monitor diverts all characters typed to 
the System Interpreter until the user gives a command that indicates 
otherwise. 

This is a request by a user to logout of the system. It disconnects all 
consoles and disk tracks that he owns, places his programs in the free 
state, and resets the Switchboard. It also writes an account record 
on the disk showing how much computing time (processing time) and 
console time was used by the user's program (s). 

This is a request for Monitor to type out the computing (processing) 
time used since login. If job CI is not specified, the job owning the 
console is assumed. If requested before login and if no job is speci- 
fied, the time-of-day is typed. If, at any time, job is specified, 
the time-of-day is typed. 
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CONSOLE MANIPULATION 



ASSIGN K CI; 



SLAVE CI; 



This is a request for console number CI to be added to those consoles 
already owned by the requesting user. 

K denotes console 

CI is the console number 

If the console is free, it will be given to the user and the user's 
Switchboard settings will be augmented by those additional entries 
which put the new console in the normal state with respect to its 
own printer and the program on the user's disk track. Cross settings 
for inter-console connectiorrs are left to the user's discretion. 

This command causes console number CI to be slaved. This means 
that console number CI will be unable to communicate with Monitor, 
and the system will ignore the call (CTRL/B) character from that 
console. However, the console may serve as an input/output device 
for the user's program. Monitor checks to make sure that the request- 
ing user owns the console he wishes to slave. It is illegal to slave 
every console that a user owns. 
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UNSLAVE CI; 



This command restores a slaved console to normal status. After this 
command, console number CI will be able to communicate with 
Monitor. The user must own the console to unslave it. 



RELEASE K CI; 



This command releases console number CI and puts it in the free 
state. Monitor checks to make sure that the requesting user owns 
the console he wishes to release. When the console is released, 
the Switchboard is reset and the input and output buffers are cleared. 
The user must own the console to release it. 
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DEVICE ALLOCATION 



ASSIGN LI; 



This is a request for access to the device specified by LI. 

LI = R for paper tape reader 

P for paper tape punch 

C for card reader 

L for line printer 

I for incremental plotter 

If device LI is not busy, it will be allocated to the user program 
issuing the command. If device LI is busy, the job number of the 
user having possession is returned. A RELEASE LI; or LOGOUT; 
will release the device. 



ASSIGN D C^- 



RELEASEL^- 
RELEASEK CI; 
RELEASE D CI; 



This command is the same as ASSIGN LI; 

D denotes DECtape unit 

CI is the unit number of the DECtape unit 



Each of these commands will annul the current assignment of the 
specified device. 
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FILE CONTROL 



OPEN CI SI C2; 



This command establishes association between an internal file num- 
ber and a file. After this command is given, the file of account 
C2 with the name SI is associated with internal file number CI. 
The internal file number specified must be between zero and three 
inclusive. If C2 is not specified, the account number of the cur- 
rent user is assumed. 



CLOSE SI; 



This command closes the files specified by SI . 

SI is a list of internal file numbers separated by spaces 

After this command is given, no writing can be done on the files 
specified, and the associations between the internal file numbers 
and the files are broken. 
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CREATE SI; 



This command causes Monifor to create a new file which is to have 
the name SI, if there is available file storage. At the time of 
creation. Monitor will enter the name of the new file and the date 
of creation Into the owner's file directory (see Appendix E) and set 
the protection mask to 17. Example: 



CREATE NEWF; 



asks Monitor to create a new file 
named NEWF. If there is no more 
file storage. Monitor will so inform 
the user (see Chapter 5). 



RENAME CI SI; 



This command renames a file. The file to be renamed must be al- 
ready open and associated with internal file number CI. Its new 
name will become SI . Example: 



RENAME 1 FOO; 



assume that file NEWF has been 
opened to internal file number 1; 
this command will change the name 
of that file from NEWF to FOO. 



REDUCE CI D1; 



EXTEND CI Dl; 



PROTECT CI C2; 



This command reduces the length of a file. The file which is to be 
shortened must be open and associated with internal file number CI . 

Dl is the number of segments to be removed from the end of 
the file. 

If Dl is greater than or equal to the number of segments in the file, 
the file is deleted from the directory. Example: 

REDUCE 2 2; assume file TT13 is opened to internal 

file number 2; this command then re- 
moves 2 segments from its end and 
returns those segments to free storage. 

This command extends the length of a file. The file which is to be 
lengthened must be open and associated with internal file number 
CI. 

Dl is the number of segments to be added to the end of the 
file. 

If there is space available. Monitor will lengthen the file as 
requested. 

This command changes the file protection mask of a file. The file 
to be protected must be open and associated with internal file 
number CI . 

C2 is the new file protection mask. 

For file protection, the 12-bit account number is partitioned into 
a project number (high order 7 bits) and a programmer number (low 
order 5 bits). Examples: 

C2 = 1 read protect against users whose project number 
differs from owner's 
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F CI; 



C2 = 2 write protect against users whose project number 
differs from owner's 

C2 = 4 read protect against users whose project number is 
same as owner's 

C2 = 10 write protect against users whose project number Is 
same as owner's 

C2 can be the sum of any of the above values. 

This command is illegal for all users except the owner. Example: 

PROTECT 1 3; read and write protect internal file 1 

against access by any user whose pro- 
ject number differs from the owner's. 

This command causes Monitor to print out the current state of the 
association of the user's internal file number CI with the file. The 
response format is 

CI SI C2 D1 
where 

CI is the owner's account number 

SI is the file name 

C2 is the protection mask 

D1 is the number of segments 
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CONTROL OF USER PROGRAMS 



START CI; 



START; 



DEPOSIT CI C2 



This command begins execution of a user program at location CI . 
In addition, the command resets the Switchboard so that all char- 
acters typed from either a keyboard or program directed Into the 
user program's input buffer are no longer intercepted by the System 
Interpreter. The accumulator (AC) and link are cleared and the 
user's Interrupt system is turned off. 

This command restarts a user program. If Monitor has been called 
during the execution of the user program, the complete state of the 
program is saved including the location of the next instruction to 
be executed. When the START command is given, the program's 
state Is restored and the program continues execution where It left 
off. As in the START CI; command, characters intended for the 
user program's input buffer are no longer intercepted by the System 
Interpreter. 

Cn;This command stores C2 in location CI, C3 in location Cl+1, ..., 
Cn in location C1+n-1. 

n is equal to or less than 10 decimal . 

A user can load a binary user program using the DEPOSIT command, 
although it is much easier using DDT -8. This command Is useful 
when making small patches to stored programs. 
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EXAMINE CI D1; This command causes Monitor to type the contents of the Dl locations 

starting at location CI. 

Dl is equal to or less than 10 decimal. 

If Dl is not specified, the contents of location CI is typed. 

3.5.1 Saving and Restoring Binary User Programs 

The SAVE, LOAD, R and RUN commands leave file SI open on internal file 3, turn the 

user's interrupt system off, and reset the Wait Mask to its initial value. 

SAVE SI; 
SAVE SI CI; 
SAVE SI CI C2; 

SAVE SI CI C2 C3; These commands write portions of the user's core image onto a file 

whose name is SI . 

CI is the file address of the first word to be written; if 

not specified, the entire 4K is written on the first 
4096 words of the file. 

C2 is the core address of the first word to be written; if 

not specified, all 4096 words are written. 

C3 is the core address of the last word to be written; if 

not specified, 77T7 is assumed. 

Example: 

SAVE NEWF; writes core words through 7777 on 

words through T7TJ of file NEWF. 

LOAD CI SI; 
LOAD CI SI C2; 
LOAD CI SI C2 C3; 

LOAD CI SI C2 C3 C4; These commands read certain portions of the file whose owner's 

account number is CI, and whose file name is SI into core. 

C2 is the file address of the first word to be read; if not 

specified, words through 7777 are read into words 
through 7777. 

C3 is the core address of the first word to be loaded; if 

not specified, all 4096 words are loaded. 

C4 is the core address of the last word to be loaded; if 

not specified, 7777 is assumed. 

Example: 

LCAD NEWF 5 10 17; loads words 5 through 14 into words 

10 through 17 respectively. 

R SI; This command is equivalent to 

OPEN 3 SI 2; LOAD 2 SI; START 

which loads program SI from the System Library (account 2) and 
starts the program running. The accumulator (AC) and link are 
cleared. 
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RUN SI; 



RUN CI SI; 



WHERE; 
USER; 
USER CI; 

SWITCH CI; 



This command is equivalent to 

OPEN 3 SI; LOAD SI; START 
The accumulator (AC) and link are cleared. 

This command is equivalent to 

OPEN 3 SI CI; LOAD CI SI; START 
The accumulator (AC) and link are cleared. 

This command stops the execution of the user program, saves its 
complete state, and sets the Switchboard so that all characters 
directed to the program's input buffer will be intercepted by 
System Interpreter. 

This command causes Monitor to type out the current state of a user 
program's location counter, accumulator, link, and switch register. 

This command causes Monitor to type out the number of the job and 
devices owned by the user. 

This command causes Monitor to type out the numbers of the devices 
owned by user CI. If job is specified, the numbers of unassigned 
devices are typed. 

This command sets the user's switch register to CI. 
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SWITCHBOARD 



Using Monitor commands the user may set, reset, and read any given bit in either the Per- 
mission Table or the Switchboard Table. See Section 2.2.1 Character Transmission and Section 2.3 
Permission and Switchboard Tables for a description of the meaning of bits in these tables. 



SET LI L2 CI L3 C2; 



This command sets a bit in either the Permission or Switchboard 
Table to a one. 

LI = P denotes Permission Table 

S denotes Switchboard Table 

L2 = K denotes keyboard 

P denotes user program 

CI is the octal number of the keyboard or program 

L3 = I denotes input buffer 

O denotes output buffer 

C2 is the octal number of the buffer which is to receive 
the characters from the character source. 

Monitor checks for appropriate ownership to decide whether it will 
allow the connection to be made. The ownership of the character 
source is used to determine legality in setting the Switchboard Table 
while the ownership of the character sink is used in setting the Per- 
mission Table. Examples: 
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SET PK 13 12; 



SET S P 4 I 16; 



requests that keyboard number 13 be 
given permission to write on the printer 
(output buffer) of console 12. 

informs Monitor that job number 4 
would like to type out characters into 
the input buffer of user program 16. 
This request will be granted only if 
user 16 has previously given permission 
by SET P P 4 I 16; or by the equivalent 
lOT instruction (SSP). 

RESET LI C2 CI L3 C2; This command is identical in all respects to the SET command above 

except that the bit indicated by the parameters will be set to zero 
instead of one. 

READ LI L2 CI L3 C2; This command uses the same parameters to specify a bit in either the 

Permission or Switchboard Table as in the SET and RESET commands 
above. Monitor will type out the value of the bit. 



DUPLEX; 



This command is a shorthand command to set the Switchboard Table 
so that characters typed on the keyboard from which this command 
is issued will appear on the printer of that console. Example: 



DUPLEX; 



if the keyboard issuing this command 
is number 16, then this command is 
equivalent to SET S K 16 16; 



ALLOW CI; 



This command is shorthand to indicate that a user is given permission 
for keyboard number CI to place characters in the output buffer of 
his console. Example: 



ALLOW 4 



assume that this command was issued 
from keyboard number 27, then it is 
equivalent to SET P K 4 27; 



LINK CI; 



This command is given by a user who wishes to communicate with a 
console other than the one at which he is setting. This command is 
legal only if the owner of the console has set the Permission Table 
so that he will accept characters from the requesting console into 
his printer's output buffer. The command is shorthand for the com- 
mand ALLOW CI; followed by the command to set the Switchboard 
so that characters from the requesting console will be placed in 
output buffer number CI . Example: 



LINK 32; 



assume that the console which issued 
this command was number 7, then this 
command would be legal only if the 
owner of console number 32 had pre- 
viously set the Permission Table to 
allow keyboard 7 access to that output 
buffer. He could have done this with 
ALLOW 7; or by SET P K 7 32; or by 
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an equivalent lOT instruction executed 
by his program. If that permission has 
been granted, the LINK commend is 
equivalent to the following two Switch- 
board commands: SET P K 32 7; 
(ALLOW 32) and SET S K 7 32; 



3.7 INTER- SYSTEM CONAMUNICATION 



In those TSS/8 systems having a local connection to a PDP-10 Time-Sharing System or a 
Synchronous Data Communication System (Type 637), the input to the user's input buffer and program 
output is scanned for the character sequences CTRL/B CTRL/X and CTRL/B CTRL/Y, respectively. All 
characters up to the next CTRL/B are diverted to the PDP-10 or 637 System, whichever the case may be. 
Characters from the PDP-10 and 637 System are directed into the user's input buffer. 
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CHAPTER 4 
INPUT/OUTPUT TRANSFER INSTRUCTIONS 

Whenever a user program executes an input/output transfer OOT) Instruction (an instruction 
of the form 6XXX) the system traps the instruction and transfers control to a system service or simulation 
routine. These routines accomplish special tasks, set up parameters for the system, and perform input/ 
output for the user program. 

lOT instructions may he separated by function into three types: 

a. Input/output instructions available on the standard PDP-8/I without a time-sharing 
monitor - when a user program executes one of these lOTs, TSS/8 simulates an input/output function 
similar to the function of the lOT instruction on the standard PDP-8/I. Some standard PDP-8/I lOT 
instructions are illegal in TSS8 (see Appendix C for a summary of legal lOTs). 

b. lOT instructions to request input/output service from TSS/8 unavailable on the standard 
PDP-8/I - these include requests for DECdisk, DECtape, high-speed paper tape reader and punch, 
card reader, and console character handling. 

c. lOT instructions which call subroutines to set user parameters or to alter the time-sharing 
environment for a particular user program - an alteration may, for example, include requests to add 

or release facilites or to change mode of character handling. 

An lOT instruction usually acts as a subroutine call. Therefore, depending upon the specific 
lOT instruction, parameters may be loaded into the accumulator (AC) before execution of the lOT. In 
some cases, the parameter in the AC acts as a pointer to a parameter block in the user's program. If 
the system has to return information to the user's program, it returns that information in the AC or in a 
block of locations in the user's program (the beginning address of this block is in the AC). 

4.1 PROGRAM CONTROL 

Check Status (CKS) Octal Code: 6200 

Operation: There are three status registers, STRO, STR1, and STR2. All three registers are 
read by the CKS instruction, and the accumulator (AC) is cleared. Before executing CKS, 
load the AC with the address of a 3-word block. Executing CKS will store in 



Word 1 
Word 2 
Words 



STRO 
STR1 
STR2 



The formats of these registers are: 

STRO Bits 

Run Bit Unconditional run (this bit is turned on when the program is 

started by the System Interpreter) 

1 PI Enable ION has been executed by user program 

2 Source Input buffer source Is being recorded 
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STRO Bits 



3 


Time 


4 
5 


Binary 
JSIOT 


6 


JSIOTC 


7 




through 
11 


Error Code 


STRl Bits 







Timer 


1 


FileO 


2 


File 1 


3 


File 2 


4 


File 3 


5 


Delimiter 


6 

7 
8 


Keyboard 

Teleprinter 

Reader 


9 


Punch 


10 


Error 


11 


Wait 


STR2 Bits 







1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 



Plotter 
DTO Flag 
DTO Error 
DTI Flag 
DTI Error 

Card Reader 
CR No Ready 
CR End File 
LP Error 
LP Done 



Input buffer time is being recorded 
Card reader mode: alphanumeric (0), binary (1) 
Non-resident lOT call (system use only) 
Copy lOT results to user (system use only) 

Bits 7 through 1 1 specify a system error code 



Time is up 

Internal file is not busy 

Internal file 1 is not busy 

Internal file 2 is not busy 

Internal file 3 is not busy 

There is a delimiter in the input buffer 

There is a character in the input buffer 

Output buffer is not full 

Character in reader buffer 

Punch buffer is not full 

System error detected, code in bits 7 through 11 of STRO 

Job is not waiting 



Plotter flag 

DECtape flag unit 

DECtape error flag unit 

DECtape flag unit 1 

DECtape error flag unit 1 

Unused 

Character in card reader buffer 

Card reader not ready 

Card reader end of file 

Line printer error 

Line printer done 

Unused 



Set Interrupt Mask (SIM) 



Octal Code: 6000 



Operation: TSS/8 simulates the PDP-8 program interrupt system for the user. A user program 
may request this mode of operation by executing the ION instruction. A simulated interrupt 
will cause an immediate transfer to location 1 of the user program. The user's current loca- 
tion (Program Counter) before the interrupt, is stored in location and the interrupt system 
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is disabled (bit 1 of STRO= 0). If the instruction following the ION is a JMP or JMS in- 
struction, it is simulated by the system before retuirning control to the user's program. 

The SIM instruction enables the user program to set those conditions which will 
result in simulated program interrupts. The system provides a mask called the Program In- 
terrupt Mask, which has the same format as the two status registers STRl and STR2 (see CKS). 

Before executing the SIM instruction, load the AC with the address of a 2-word 
block containing the mask. After executing the SIM instruction, a bit match between the 
status registers and the Program Interrupt Mask will result in a simulated interrupt if the 
interrupt system is enabled. The user's program may do a CKS instruction to determine the 
cause of the interrupt. 

The Program Interrupt Mask is normally set to 

0074 
7677 

and is reset only on LOGOUT. The AC is cleared by SIM. 

Read Interrupt AAask (RIM) Octal Code: 6003 

Operation: The Program Interrupt Mask is read into two locations starting at the location 
whose address is in the AC, and the AC is cleared. 

Interrupt Turn On QON) Octal Code: 6001 

Operation: This instruction enables TSS/8 to respond to a user program interrupt request by 
setting bit 1 of STRO = 1 . If the user interrupt is disabled (bit 1 of STRO = 0) when this in- 
struction is given and the following instruction is a JMP or JMS instruction, TSS/8 executes 
it, then enables the interrupt by returning control to the user program. This instruction has 
no effect if given when the user interrupt is enabled. 

Interrupt Turn Off (lOF) Octal Code: 6002 

Operation: This instruction disables the user program interrupt system by setting bit 1 of 
STRO = 0. 

Set Wait Mask (SWM) Octal Code: 6005 

Operation: The user program may request to be dismissed until some condition has been met. 
This is done by setting a mask through which the system will observe the status register of the 
user program. Load the AC with the address of a 2-word block containing 1 bits In the desired 
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wait conditions. The two words are inclusively ORed with the wait mask and the AC is 

cleared. In general, flag test lOTs whose skip condition is not met and requested I/O 

operations which cannot be performed immediately, cause the program to be dismissed until 

the condition is met. 

For example, suppose it is desired that the user program be dismissed until any 

character is typed, then 

TAD MASK 

SWM 

KSF 

• 

MASK, 0040 
0000 

would have the desired effect. 

The normal setting of the Wait Mask is 

0001 
7767 

and is reset on LOGIN, SAVE, LOAD, R and RUN commands. 

Clear Wait Mask (CWM) Octal Code: 6006 

Operation: Same as Set Wait Mask (SWM) except that the selected bits are cleared and 
the AC is cleared. 

Read Wait Mask (RWM) Octal Code: 6007 

Operation: The contents of the user's Wait Mask are read into two successive locations be- 
ginning at the word whose address is in the AC, and the AC is cleared. 

Wait (WAIT) Octal Code: 6410 

Operation: The user's program is dismissed until it is re-scheduled by some status bit/Wait 
Mask match. The user may read the status registers to determine the restart conditions. 

User (USE) Octal Code: 6421 

Operation: Return in the AC the number of the current job. 
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Console (CON) Octal Code: 6422 

Operation: Return in the AC the smallest unit number of the unslaved consoles assigned to 
the job whose number Is in the AC. If the AC is 0, the number of an unassigned console is 
returned; if it does not exist, -1 is returned. 

User Run Time (URT) Octal Code: 6411 

Operation: Returns the total run time of the user program in the two locations starting at the 
location whose address is in the AC. The AC is cleared. 

Time-Of-Day (TOD) Octal Code: 6412 

Operation: Returns the value of the System Clock in the two locations starting at the loca- 
tion whose address is in the AC. The AC is cleared. 

Return Clock Rate (RCR) Octal Code: 6413 

Operation: The number of milliseconds per clock tick is returned in the AC. 

Date (DATE) Octal Code: 6414 

Operation: Returns the date in the AC. The format of this 12-bit number is 
DATE=((YEAR-1964)*12*(MONTH-l))*31+DAY-l 

Skip On TSS/8 (TSS) Octal Code: 6420 

Operation: This instruction is used by programs which run under both TSS/8 and a standard 
PDP-8/I. Under TSS/8, the instruction following TSS will be skipped. On a standard 
PDP-8/I, the lOT has the effect of a NOP instruction. 

Halt (HIT ) Octal Code: 7402 

Operation: This instruction is used to stop the user program and to pass control to the System 
Interpreter, Executing HLT is exactly equivalent to typing CTRL/B S RETURN. HLT may be 
micro-coded with other group 2 lOT's (see Small Computer Handbook, C-800). 
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Quantum Synchronization (SYN) Octal Code: 6415 

Operation: Upon execution of this instruction, the system will dismiss the user program and 
set it in the run state so that it will be run again next time through the "round-robin. " 
Ordinarily, this instruction is used to insure a full time quantum to perform some critical 
operation. 

Set Timer (STM) Octal Code: 6416 

Operation: The system provides a clock time for each user program. By means of this lOT, 
the timer may be set to "fire" after a specified number of clock ticks have elapsed. 

Load the AC with the time in ticks to prime the timer. Upon execution of the STM 
instruction, the system sets the timer to "fire" in the specified number of ticks, and turns the 
timer bit (bit 0) in status register 1 to and clears the AC. After the specified time has 
elapsed, the system turns bit back to 1. 

The timer mechanism may be used three ways: 1) The user may set the time going 

and use the CKS lOT to find out when the time is up 2) The timer may be used with the Wait 

feature. 

TAD C5000 /Prime timer with 5000q ticks 
STM ^ 

TAD MASK /Set the Wait Mask to check bit 

SWM /of status register 1 

• 

MASK, 4000 

0000 

C5000, 5000 

Here the user program will be dismissed until 5000 ticks have elapsed 3) The time may also 

be used in conjunction with the interrupt system. In this case, an interrupt will occur after 

the specified number of ticks. 

Assign Device (ASD) Octal Code: 6440 

Operation: If the device specified by the contents of the AC is available, it will be assigned 
to the user program and the AC cleared. Otherwise, the number of the user program having 
the device is placed in the AC. If the device does not exist, 7111 is returned in the AC. 
The left half of the AC specifies the device type and the right half specifies the 
unit number. 
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AC Bits 


0-5 


AC Bits 6-1 1 


Device 







K 


Console K 


40 







Paper tape reader 


40 




1 


Paper tape punch 


40 




2 


Line printer 


40 




3 


Plotter 


40 




4 


Card Reader 


40 




N+5 


DECtape unit N 



This assignment is in effect until a corresponding REL instruction or LOGOUT is encountered. 

Release Device (REL) Octal Code: 6442 

Operation: The device specified by the contents of the AC is released. If the device was 
not assigned by ASD, the release is a NOP. Otherwise, the device is made available to 
other users. The AC is cleared. 

Slave A Console (SLV) Octal Code: 6402 

Operation: SLV enables a user program to slave a console belonging to the user. When a 
console is slaved, the call (CTRL/B) character is treated as an ordinary character rather than 
as the System Interpreter call character. This means that the slaved console may not call the 
System Interpreter. 

Load the AC with the number of the console to be slaved, then execute SLV. If 
the console specified does not belong to the user, this lOT will be considered illegal and the 
AC will be non-zero. Otherwise, the AC is cleared. 

Unslave A Console (UNS) Octal Code: 6403 

Operation: UNS removes a slaved console from the slave state. The call character resumes 
its power to call the System Interpreter. 

Load the AC with the number of the console to be released from the slave state, 
then execute UNS. If the console specified is not a slave or does not belong to the user, 
this lOT will be considered a NOP. The AC is cleared. 

Set Switchboard and Permission Tables (SSP) Octal Code: 6404 

Operation: SSP is used to set, reset, and read bits In the Switchboard and Permission Tables. 
Its use mirrors the format of the Monitor commands for the same purpose. 
Load the AC with the beginning address of a 3-word block: 
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Word 1 : Bits and 1 contain 0, 1, 2, or 3 

reset the bit in the table 

1 read the bit in the table - the value of the bit is 
returned in the AC after executing SSP 

2 set the bit in the table 

3 link - set both tables 

Bit 9 contains or 1 

reference the Switchboard Table 

1 reference the Permission Table 

Bit 10 contains or 1 

reference the keyboard rows of the table 

1 reference the programs typing out rows of the table 

Bit 1 1 contains or 1 

reference the input columns of the table 

1 reference the output columns of the table 

Word 2: contains the number of the keyboard or program typing out 

to be referenced 

Word 3: contains the number of the input or output buffer to be 

referenced 

If SSP is executed, the AC is set to 0, otherwise, to 7711 . As an example of the 
use of SSP to duplicate the effect of the Monitor command SET P K 13 7; (set the Permission 
Table to give permission for the keyboard of console 13 to type into the output buffer of con- 
sole 7) execute the following sequence: 

TAD ARRAY 
SSP 

• 

ARRAY, .+1 
4005 
13 

7 

As an example of console linking, the Monitor command LINK 3; (set the Permission Table 
to give permission for the keyboard of console 3 to type into the output buffer of this job 
and set the Switchboard Table to route keyboard input to this job to the output buffer of 
console 3) is equivalent to: 
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USE 

CON 

DCA TABLE+2 

TAD TABLE 

SSP 



TABLE, .+1 
6000 

3 



Set Switch Register (SSW) Octal Code: 6430 

Operation: Each user program has a switch register corresponding to the PDP-8/I switch 
register. This lOT stores the contents of the AC in the user's switch register, and the AC 
is cleared. 

OR With Switch Register (OSR) Octal Code: 7404 

Operation: The contents of the user's switch register are inclusively ORed into the AC. 
OSR may be micro-coded with other group 2 lOT's (see Small Computer Handbook, C-800). 

4.2 FILE CONTROL 

All bulk data storage for user programs is on file on the disk. This area is referred to col- 
lectively as file storage. A user program may read or write a file to handle bulk input/output of text 
or binary information. 

Files are composed of sequential segments of file storage. The size of a file segment is an 
integer multiple of disk records specified at system initialization time. A record consists of 128 12-bit 
machine words. Files are at least one segment long and grow by adding additional segments to the end 
of the file. Each file is registered in the owner's file directory by a name which may be any string of 
not more than six 6-bit characters. 

Each user may refer to four files simultaneously. An internal file number (0, 1, 2, or 3) is 
associated with each of the user program's active files. All references to file storage is by internal file 
numbers. The act of associating an internal file number with a file referenced by an account number 
and name is called "opening" the file. 

All file lOTs that are successfully completed return to the user with the AC cleared. A non- 
zero AC indicates that an error was detected and the lOT was not performed. The error messages are 
as follows: 
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AC = 4000 The internal file specified is not open 

AC = 4400 The file is open to another user 

AC = 5000 The directory is full 

AC = 6000 File protection violation 

AC = 7000 File not found 

AC =7400 Disk is full 



Read File (RHLE) and Write File (WFILE) Octal Codes: 6603 and 6605 

Operation: Once the association of a file with an internal file number has been made, these 
lOTs allow the actual file reference to be made. They are illegal on a file that has not been 
opened (associated with an internal file number). 

To read or write a file, load the AC with the address of a 6-word block, then 
execute the lOT. The format for the 6-word block is: 

Word 1: contains the high-order file word address 

Word 2: contains the internal file number 

Word 3: contains the negative of the number of words for the operation. 

This number will be either the number of words to be read or 
the number of words to be written. 

Word 4: contains a pointer to the beginning address -1 of a buffer lo- 

cated in the user program. On a read operation this buffer 
will receive the information from the file; on a write opera- 
tion this buffer holds the information that is to be sent to the 
file. 

Word 5: contains the least significant 12 bits of the initial file word 

address to begin the operation. 

Word 6: contains an error code: 

if no error 

1 if parity error 

2 if file shorter than word count 

3 if file not open 

4 if protection violated 

The read or write begins at the word specified by words 1 and 5. For example: 

TADX 
WFILE 

• 

X, .+1 


1 

-200 
6477 
200 

means, write 200 words starting at word 200 of the file that is associated with internal 

file number 1 from a buffer starting at location 6500. 
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After the lOT is given, the file request is placed in the file request queue, and the 
corresponding file-inactive bit is cleared in status register 1 for the user program. Execution 
of the user program continues immediately without waiting for the file request to be com- 
pleted. If the Wait Mask contains a 1 in the bit corresponding to the inactive bit for that 
file, however, the user program will be dismissed until the file request has been completed. 

The file queue is one deep for each of the user program's internal file numbers, 
therefore, four different file requests may be overlapped if they refer to the four different 
internal file numbers. An attempt to overlap a file request on the same internal file number 
will result in the user program being dismissed until the first request on that internal file 
number has been completed. After completion of any file request, the corresponding file 
inactive bit in status register 1 is set to 1 and the word count (word 3) and core address 
(word 4) are updated, and the error code is set in word 6. 

Rename A File (REN) Octal Code: 6600 

Operation: REN is used to change the name of a file. Load the AC with the beginning 

address of a 4-word block, where 

Word 1 : contains the internal file number associated with the file 

whose name is to be changed, that is, to rename a file one 
must first open it, otherwise, REN is illegal. 

Words 2 through 4: contain the new name. This name is in 6-bit characters 

packed two to a word. 

Open A File (OPEN) Octal Code: 6601 

Operation: OPEN is used to associate a file with an internal file number. This process, 

called "opening", is necessary since all file operations are in terms of the internal file 

numbers. Before executing the OPEN lOT, load the AC with the beginning address of a 

5-word block, where 

Word 1: contains the internal file number. 

Word 2: contains the account number of the owner of the file. If 0, 

the account number of the current user is specified. 

Word 3 through 5: contain the name of the file to be opened. This name is in 

6-bit characters packed two to a word. 

If there was another file associated with the internal file number before the execution of 

the OPEN lOT, it will be closed automatically before the new file is associated with the 

internal file number. 
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Close A File (CLOS) Octal Code: 6602 

Operation: CLOS terminates the association between files and their internal file numbers. 
Before executing CLOS, load the AC with a selection pattern for the internal file numbers 
whose associated files are to be closed. The file is closed if bit I is 1, where I = bit 0, 1, 
2, or 3. 

Protect A File (PROT) Octal Code: 6604 

Operation: The owner of a file may protect his file from unauthorized attempts to access it 
by using this instruction. Before executing PROT, load the AC with 

Internal file number of the reserved file to be protected. 

Write protect against owner. 

Write protect against users whose project number is same as 
owner's. 

Read protect against users whose project number is same as 
owner's. 

Write protect against users whose project number differs from 
owner's. 

Read protect against users whose project number differs from 
owner's. 

A file must be opened before it can be protected. PROT is legal only when performed by the 

file owner, that is, the user who created the file. Ail attempts to access the file which 

violate any of the protection flags will be considered illegal. 

File Information (HNF) Octal Code: 6613 

Operation: FINF enables a user program to determine what file, if any, is associated with 

an internal file number. Load the AC with the beginning address of a 7-word block, where 

Word 1: contains the internal file number for which the user program 

wishes information. 

Words 2 through 7 will contain the information that the system returns after executing FINF. 

Word 2: contains the account number of the owner or zero if no file 

is associated with the interna! file number, that is, the file 
is not open. 

Words 3 through 5: contain the name of the file in 6-bit code. 



Bits 5 through 


6 


Bit 7 




Bits 




Bit 9 




Bit 10 




Bit 11 
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Word 6: confains 

BH=1 Means 

7 write protected against owner 

8 write protected against users whose project number 
is same as owner's 

9 read protected against users whose project number 
is same as owner's 

10 write protected against users whose project number 
differs from owner's 

n read protected against users whose project number 

differs from owner's 

Word 7: contains the number of segments that the file contains. 

Create A File (CRF) Octal Code: 6610 

Operation: The user may request the system to create a new file of one segment. The user 
program provides the new name for the file. Load the AC with the beginning address of a 
3-word block, where 

Words 1 through 3: contain the 6-character name. 

If there is some reason why the request cannot be granted, the system will return a non-zero 
error code in the AC. The protection of a newly created file is 17. 

Extend A File (EXT) Octal Code: 661 1 

Operation: To extend the length of an existing file, that file must be currently open. Load 

the AC with the beginning address of a 2-word block, where 

Word 1: contains the internal file number of the file to be extended. 

Word 2: contains the number of segments the system should append to 

the file. 

If for some reason the request to extend a file cannot be granted, the AC wi II contain 4000, 

4400, 6000, or the number of segments it failed to append. 

Reduce A File (RED) Octal Code: 6612 

Operation: To reduce the length of an existing file, that file must be currently open. Load 
the AC with the beginning address of a 2-word block, where 

Word 1 : contains the internal file number of the file to be reduced. 

Word 2: contains the number of segments to be removed. 

This request will always be granted. 
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Segment Size (SIZE) 



Octal Code: 6614 



Operation: The number of words per segment is returned in the AC. 



Account (ACT) 



Octal Code: 6617 



Operation: The account number of the job whose number is in the AC is returned in the AC. 
If the AC is 0, the current job is assumed. If is returned in the AC, the specified job does 
not exist. 



Who (WHO) 



Octal Code: 6616 



Operation: The account number and password of the current job are returned to the three- 
word block whose address is in the AC, and the AC is cleared. 



4.3 INPUT BUFFER CONTROL 



Set Keyboard Break (KSB) 



Octal Code: 6400 



Operation: Rather than activate the user program to receive each character as it is placed 
in the input buffer, TSS/8 saves time by activating the program only on certain conditions 
specified by the user. These activation conditions are called delimiters. Before executing 
KSB, load the AC with a 12-bit delimiter table. The format of the table is as follows: 
(where each bit = 1) 



Bit 


1 
2 
3 

4 



6 

7 

8 
9 
10 
11 



Specifies 



change of character source 
all letters 


all numerals 
space 
line feed 
form feed 
1 " 


horizontal tab 
vertical tab 

carriage return 

1 


1 

[ ] 

& * 

/ < 

@ \ 


9 

(' ) 

> 

* $ 



RUBOUT 

ALT MODE 

all characters not specified in bits 1 through 10 



4-14 



When a bif in the table is set to 1 , the user's program is activated if the condition the bit 
represents is met by the incoming character, or if the input buffer becomes full. The delimiter 
table is initialized to 3777 on LOGIN and ASSIGN. KSB clears the AC. 

Set Buffer Control Flags (SBC) Octal Code: 6401 

Operation: SBC permits the user program to clear his input and output buffers and control 
the recording of character time and source in his input buffer. Before executing SBC, load 
the AC with the desired flags whose functions are 

Bit 



Clear output buffer 

1 Clear input buffer 

2 Record character source 

3 Record character time 

If bit 2=1, the source of each character in the input buffer is recorded in the following 
character position. The source from which the character was generated is indicated by the 
8-bit character as follows: 

OXX Console XX keyboard 

IXX User program XX typing out 

1 72 637 typing out 

174 PDP-10 typing out 

177 System Interpreter typing out 

Bit 2 of status register is set to 1 . If AC bit 2=0, source recording in the input buffer is 
suppressed and bit 2 of status register is set to 0. 

If AC bit 3=1, the time of receipt of each input character is recorded in the two 
successive character positions following the character or following the source. If the time 
is being recorded, bit 3 of status register is set to 1 . 

If AC bit 3=0, time recording in the input buffer is suppressed and bit 3 of status 
register is set to 0. The AC is cleared by SBC. 

Skip On Keyboard Flag (KSF) Octal Code: 6031 

Operation: The keyboard flag is sensed, and if it contains a binary 1, the contents of the 
PC is incremented by one so that the next sequential instruction is skipped. The keyboard 
flag is bit 6 of status register 1 , and it has a value of 1 whenever the input buffer is not 
empty. If the keyboard flag is and the keyboard wait flag (bit 6 of wait register 1) is 1, 
the job is placed in the active state until the keyboard flag is 1 . If the keyboard wait flag 
is 0, control returns to the calling program immediately. 
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Clear Keyboard Flag (KCC) Octal Code: 6032 

Event Time: 2 

Operation: The AC is cleared, and if the input buffer is empty, the keyboard flag is cleared. 

Read Keyboard Buffer Static (KRS) Octal Code: 6034 

Event Time: 3 

Operation: If the input buffer is not empty, the next character from the input buffer is 
inclusively ORed into bits 4 through 1 1 of the AC. This is a static command in that neither 
the AC nor the keyboard flag is cleared. If fhe input buffer is empty and the keyboard wait 
flag is 0, no operation is performed and control returns immediately to the user's program. 
If the keyboard wait flag is 1, the job is placed in the active state until the keyboard flag 
is 1 . 

Read Keyboard Buffer Dynamic (KRB) Octal Code: 6036 

Event Time: 2,3 

Operation: Identical to KCC followed by KRS. 

Read Keyboard String (KSR) Octal Code: 6030 

Operation: Before executing KSR, load the AC with the address of a 2-word block, where 
Word 1: contains the negative of the number of characters to read. 

Word 2: contains the address -1 of the first word of the buffer. 

If the keyboard wait flag is 1, control does not return to the user program until a break 
condition (see KSB) is satisfied or until the word count in word 1 is reduced to zero. If the 
keyboard wait flag is 0, control returns to the user program immediately; control returns to 
the location following the KSR, the negative of the number of characters remaining to be 
transferred is in word 1, and word 2 points to the last character stored. The AC is cleared. 

4.4 OUTPUT BUFFER CONTROL 

Send A String (SAS) Octal Code: 6040 

Operation: To send a string, load the AC with the address of a 2-word block, where 
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Word 1 : contains the negative of the number of characters to be sent. 

Word 2: contains the address -1 of the first word of the string. 

The characters are stored one per word right Justified starting at the address specified by 
word 2. Upon execution of SAS, the system takes only as many characters as will fit in the 
output buffer. It then makes the appropriate adjustment to word 2 to indicate a new starting 
address and to word 1 to indicate the reduced character count; it returns to the instruction 
following the SAS. If the character count is reduced to zero, the instruction following the 
SAS is skipped. The instruction following the SAS may contain a JMP .-1 to continue the 
block transfer of Teletype characters. In this case, the user program will dismiss until the 
Teletype output buffer is nearly empty. If the user wishes to avoid dismissal, he can place 
a jump to another port of his program in the instruction following SAS. The AC is cleared 
by SAS. 

Skip on Teleprinter Flag (TSF) Octal Code: 6041 

Event Time: 1 

Operation: The teleprinter flag is sensed, and if it contains a binary 1, the contents of the 
PC is incremented by one so that the next sequential instruction is skipped. The teleprinter 
flag is bit 7 of status register 1, and has a value of 1 if the output buffer is not full. If the 
teleprinter wait flag is 0, control returns to the user program immediately, otherwise, con- 
trol returns when the teleprinter flag is I . 

Clear Teleprinter Flag (TCP) Octal Code: 6042 

Event Time: 2 

Operation: The teleprinter flag is cleared to zero. 

Load Teleprinter And Print (TPC) Octal Code: 6044 

Event Time: 3 

Operation: The character in bits 4 through 11 of the AC is typed out and routed through 
the switchboard to all buffers connected to the user's program character output. 
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Load Teleprinter Sequence (TLS) Octal Code: 6046 

Event Time: 2, 3 
Operation: Same as TPC. 

4.5 HIGH-SPEED PAPER TAPE READER 

Skip On Reader Flag (RSF) Octal Code: 6011 

Event Time: 1 

Operation: The reader flag is sensed, and if it contains a binary 1 , the contents of the PC 
is incremented by one so that the next sequential instruction is skipped. The reader flog is 
bit 8 of status register 1, and has a value of 1 if the reader buffer is not empty. If the reader 
wait flag in the wait mask is 1, the program is dismissed until the reader flag is 1, otherwise, 
control returns to ffie user program immediately. 

Read Reader Buffer (RRB) Octal Code: 6012 or 6016 

Event Time: 2 

Operation: The contents of the reader buffer is transferred into bits 4 through 1 1 of the AC 
and the reader flag is cleared if the reader buffer is empty. This instruction does not clear 
the AC. If the reader buffer is empty and the reader wait flag is 1, the user program is dis- 
missed until the reader flag is 1. If the reader buffer is empty and the reader wait flag is 0, 
this lOT is a NOP. 

Reader Fetch Character (RFC) Octal Code: 6014 

Event Time: 3 

Operation: The reader flag and the Monitor reader buffer are both cleared, the reader is 
started to fill the Monitor reader buffer and the reader flag is set after the first character is 
read. 

Read Reader String (RRS) Octal Code: 6010 

Operation: RRS allows a user program to read a string of characters from the paper tape 
reader. Before executing RRS, load the AC with the beginning address of a 2-word block, 
where 

Word 1 : contains the negative of the number of characters to read. 

Word 2: contains the address -1 of the first word of a buffer. 



4-18 



If the reader wait flag in the wait mask is 1, the program is dismissed until the transfer is 
completed, otherwise, control returns to the user program immediately. The reader flag is 
set to 1 when the transfer is complete. The AC is cleared by RRS. 

4.6 HIGH-SPEED PAPER TAPE PUNCH 



Skip On Punch Flag (PSF) Octal Code: 6021 

Event Time: 1 

Operation: The punch flag is sensed, and if it contains a binary 1, the contents of the PC 
is incremented by one so that the next sequential instruction is skipped. The punch flag is 
bit 9 of status register 1 , and has a value of 1 if the punch buffer is not full. If the punch 
flag is 1 and the punch wait flag is 1, the program is dismissed until the punch flag is 1. 
If the punch flag is and the punch wait flag is 0, no operation is performed and control 
returns to the user program immediately. 

Clear Punch Flag (PCF) Octal Code: 6022 

Event Time: 2 

Operation: If the punch buffer is not full, the punch flag is cleared in preparation for 
punching the next character from the computer. If the punch buffer is full and the punch 
wait flag is 1, the program is dismissed until the punch flag is 1. If the punch buffer is full 
and the punch wait flag is 0, no operation is performed and control returns to the user pro- 
gram immediately. 

Load Punch Buffer and Punch Character (PPC) Octal Code: 6024 

Event Time: 3 

Operation: An 8-bit character is transferred from bits 4 through 11 of the AC into the punch 
buffer and then this character is punched. PPC does not clear the punch flag. If the punch 
buffer is full and the punch wait flag is 1, the program is dismissed until the punch flag is 
1 . If the punch buffer is full and the punch wait flag is 0, no operation is performed and 
control returns to the user program immediately. 
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load Punch Buffer Sequence (PLS) Octal Code: 6026 

Event Time: 2, 3 

Operation: Identical to PCF followed by PPC. 

Punch String (PST) Octal Code: 6020 

Operation: PST allows a user program to punch a string of characters. Before executing PST, 

load the AC with the beginning address of a 2-word block, where 

Word 1 : contains the negative of the number of characters to be punched. 

Word 2: contains the beginning address -1 of the string to be punched; 

the characters should be right justified one per word. 

Upon execution of PST, the system takes only as many characters as will fit in the punch 
buffer; it then makes the appropriate adjustment to word 2 to indicate a new starting address 
and to word 1 to indicate the reduced character count. It returns to the instruction follow- 
ing the PST. If the character count is reduced to zero, the instruction following PST is 
skipped. The AC is cleared by PST. 



4.7 DECTAPE 



Load Status Register A (DTXA) Octal Code: 6764 

Operation: DTXA allows a user program to read and write records (128-word blocks) on 
DECtape. Load the AC with the beginning address of a 4-word block, where 
Word 1 : contains 

Bit=l 



0-2 contain the transport unit select number 

6-8 = 2 for read data function 

4 for write data function 

9=0 to disable DECtape control flag (DTCF) and error 

flag from causing a program interrupt. 
1 to enable DECtape control flag (DTCF) and error 

flag to cause program interrupt 
10-11 unused 



Word 2 
Words 
Word 4 



contains the beginning DECtape block number 
contains the negative of the number of records to transfer 
contains the beginning core address -1 of record buffer 
After DTXA is given, the DECtape request is placed in the DECtape request queue and the 
DECtape and error flags are cleared in status register 2. Execution of the user program con- 
tinues immediately without waiting for the DECtape request to be completed. If the wait 
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mask contains a 1 bit corresponding to the DECtape flag of the selected unit, the program 
will be dismissed until the DECtape request has been completed. The DECtape queue is one 
deep for each unit, therefore, four different DECtape requests may be overlapped if they 
refer to different units. An attempt to overlap a DECtape request on the same unit will 
result in the user program being dismissed until the first request has been completed. After 
the completion of any DECtape request, the corresponding DECtape flag in status register 2 
is turned on. The AC is cleared by DTXA. 

Skip On Flags (DTSF) Octal Code: 6771 

Event Time: 1 

Operation: The contents of both the error flag and the DECtape flag is sampled, and if 
either flag contains a binary 1, the contents of the PC is incremented by one to skip the 
next sequential instruction. If both flags are zero and if either of the corresponding wait 
flags are 1, the user program is dismissed until the skip condition is satisfied. 

Read Status Register B (DTRB) Octal Code: 6772 

Event Time: 2 

Operation: The contents of DECtape status register B is loaded into the AC by an OR trans- 
fer. The AC bit assignments are: 

= error flag 

1 = mark track error 

2 = end of tape 

3 = select error 

4 = parity error 

5 = timing error 
6 

through = unused 

10 

1 1 = DECtape flag 

4.8 AUTO^AATIC LINE PRINTER 



The Automatic Line Printer and Control (Type 645) lOT instructions are simulated precisely as 
they appear In the Small Computer Handbook. The line printer error flag is bit 10 of status register 2, 
and the done flag is bit 11 of the some register. The wait mask and priority interrupt mask have the 
same significance as with other devices. 
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Skip On Line Printer Error (LSE) Octal Code: 6651 

Event Time: 1 

Operation: The contents of line printer error flag is sensed, and if it contains a binary 1, 
indicating that an error has been detected, the contents of the PC is incremented by one so 
that the next sequential instruction is skipped. 

Symbol: If Line Printer Error Flag = 1, then PC+1 -PC 

Clear Printer Buffer (LCB) Octal Code: 6652 

Event Time: 2 

Operation: Both sections of the line printer buffer are cleared in preparation for receiving 
new character information. 
Symbol: - LPB 

Load Printer Buffer (LLB) Octal Code: 6654 

Event Time: 3 

Operation: A section of the printer buffer is loaded from the contents of bits 6 through 1 1 of 
the AC, then the AC is cleared. 

Symbol: AC 6 through 1 1 -* LPB, then -AC 

Skip On Line Printer Done Flag (LSD) Octal Code: 6661 

Event Time: 1 

Operation: The contents of the line printer done flag is sensed, and if it contains a binary 
1, the contents of the PC is incremented by one so that the next sequential instruction is 
skipped. 

Symbol: If Line Printer Done Flag = 1, then PC+1 -PC 

Clear Line Printer Flags (LCF) Octal Code: 6662 

Event Time: 2 

Operation: The line printer done and error flags are cleared. 

Symbol: -Line Printer Done Flag 
- Line Printer Error Flag 
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Clear Formaf Register (LPR) Octal Code: 6664 

Event Time: 3 

Operation: The line printer format register (FR) is cleared and then loaded from the contents 
of bits 9 through 11 of the AC, and the AC is cleared. The line contained in the section of 
the printer buffer (LPB) loaded last is printed. Paper is advanced in accordance with the 
selected channel of the format tape if the contents of ACS is a 1 . If ACS is a 0, paper 
advance is inhibited. 



4.9 INCREMENTAL PLOTTER 



The Incremental Plotter and Control (Type 350B) lOT instructions are simulated precisely as 
they appear in the Small Computer Handbook. The plotter flag is bit of status register 2. The wait 
mask and priority interrupt mask have the same significance as with other devi ces . 

Skip On Plotter Flag (PLSF) Octal Code: 6501 

Event Time: 1 

Operation: The plotter flag is sensed, and if it contains a 1 the contents of the PC is 
incremented by one so that the next sequential instruction is skipped. 
Symbol: If Plotter Flag = 1, then PC + 1 -PC 

Clear Plotter Flag (PLCF) Octal Code: 6502 

Event Time: 2 

Operation: The plotter flag is cleared in preparation for issuing a plotter operation command. 
Symbol: "* Plotter Flag 

Pen Up (PLPU) Octal Code: 6504 

Event Time: 3 

Operation: The plotter pen is raised from the surface of the paper. 

Pen Right (PLPR) Octal Code: 6511 

Event Time: 1 

Operation: The plotter pen is moved to the right in either the raised or lowered position. 
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Drum Up (PLDU) Octal Code: 6512 

Event Time: 2 

Operation: The plotter paper drum is moved upward. This instruction can be combined with 
the PLPR and PLDD instructions. 



Drum Down (PLDD) Octal Code: 6514 

Event Time: 3 

Operation: The plotter paper drum is moved downward. 

Pen Left (PLPL) Octal Code: 6521 

Event Time: 1 

Operation: The plotter pen is moved to the left in either the raised or lowered position. 

Drum Up (PLUD) Octal Code: 6522 

Event Time: 2 

Operation: The plotter paper drum is moved upward. This instruction is similar to PLDU 
except that it can be combined with PLPL or PLPD instructions. 

Pen Down (PLPD) Octal Code: 6524 

Event Time: 3 

Operation: The plotter pen is lowered to the surface of the paper. 



4.10 CARD READER 



Skip on Card Reader Flag (CRSF) Octal Code: 6632 

Event Time: 2 

Operation: The contents of the card reader flag is sensed, and if it contains a 1 (indicating 
that the card column is present for reading), the contents of the PC is incremented by one so 
that the next sequential instruction is skipped. The card reader flag is bit 6 of status register 
2 and it has the value 1 if a card is in the card buffer. If the card reader flag is and the 
card reader wait flag is 1, the program is dismissed until the card reader flag is 1; otherwise, 
control returns to the user program immediately. 
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Read Card Equipment Status (CERS) Octal Code: 6634 

Event Time: 3 

Operation: The contents of the card reader flag and status flags are transferred into the 
contents of bits 7 through 9 of the AC. The AC bit assignments ore: 

7 card reader flag (1 if card in TS8 card reader buffer) 

8 not ready (covers not in place, power is off, start pushbutton has not been 
pressed, hopper is empty, stacker is full, a card is jammed, a validity check 
error has been detected, or the read circuit is defective) 

9 end of file (EOF) (hopper is empty and operator has pushed EOF button) 



Read Card Reader Buffer (CRRB) Octal Code: 6671 

Event Time: 1 

Operation: The contents of the card column buffer is transferred into the AC and the card 
reader flag is cleared if the card reader buffer is empty. One CRRB reads either alphanumeric 
or binary information. If the card reader buffer is empty and the card reader wait flag is 
1 , the program is dismissed until the card reader flag is 1 . If the card reader buffer is empty 
and the card reader wait flag is 0, no operation is performed and control returns to the user 
program immediately. 

Select Alphanumeric (CRSA) Octal Code: 6672 

Event Time: 2 

Operation: The card reader alphanumeric mode is selected and a card is read into the cord 
reader buffer. Information read into the card reader buffer is in 6-bit alphanumeric form 
(the Hollerith code representing the decoded 12-row character in one column). If the card 
reader wait flag is 1, the user program is dismissed until the card reader flag is 1; otherwise, 
control returns to the user program immediately. 

Select Binary (CRSB) Octal Code: 6674 

Event Time: 3 

Operation: The card reader binary mode is selected and a card is read into the card reader 
buffer in 12-bit binary form. If the card reader wait flag is 1, the user program is dismissed 
until the card reader flag is 1; otherwise, control returns to the user program immediately. 
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Upon instruction to read the card reader buffer, the contents of the 12-bit column 
is transfen-ed into the AC. In the alphanumeric mode a 6-bit Hollerith code is transferred 
into bits 6 through 1 1 of the AC, and bits through 5 of the AC are cleared. In the binary 
mode, the binary contents of the 12 bits (or rows) in a card column are transferred into the 
AC so that row X is read into AC bit 0, row Y into AC bit 1 , row into AC bit 2, . . . , and 
row 9 into AC bit 11. The mode is specified by either the CRSA or CRSB instruction. 

Read Card String (RCS) Octal Code: 6630 

Operation: RCS allows the user program to read a string of characters from the cord reader. 
Before executing RCS, load the AC with the beginning address of a 2-word block, where 

Word 1 : contains the negative of the number of columns to be read. 

Word 2: contains the address -1 of the first word of a buffer. 

If the transfer is terminated before the column count has been reduced to zero, the card 
reader flag is turned on the words 2 and 1 contain the address -1 of the next buffer location 
and the negative of the number of columns remaining to be read, respectively. Columns are 
packed right justified, one per word independent of mode. 
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CHAPTER 5 
ERROR DIAGNOSTICS 



5.1 



USER PROGRAM 



The following error messages are typed on the user's printer by the Error Phantom when error 

conditions occur in a running user program. If the user program is not enabled for system error interrupts, 

the error messages are typed in the following format. 

SI FOR USER CI 
AC=C2, L=C3, PC=C4 
INSTR-C5 

SI is a string, describing the nature of the illegal instruction C5 which user program CI has executed at 

location C4. At the time the illegal instruction was executed the value of the accumulator was C2 and 

the value of the link was C3. For example. 



ILLEGAL lOT 



The user program has executed an lOT which the system regards 
as illegal. The illegality may be for one of two reasons: 

1. The lOT itself may be illegal. 

2. The parameters to a legal lOT may invalidate it. 
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SYSTEM INTERPRETER 



The following error messages result from illegal requests to the System Interpreter. They are 
printed by the System Interpreter on the printer. 



SI ? 



ILLEGAL REQUEST 



SWITCHBOARD ERROR 



The System Interpreter does not understand the command. 
SI = command 

The user has requested an illegal service. This error usually 
results when some parameter has been given an incorrect value 
or the request refers to a facility not owned by the user. 

The user has attempted to set a Permission Table bit not owned 
by him; or the user has attempted to make a connection in the 
Switchboard Table for which permission has not been granted. 



SAVE LIMIT ERROR 

CONSOLE IN USE 
LOGOUT TO 
RELEASE 

LOGIN PLEASE 



The user has given invalid bounds in the command to save binary 
core image. The first bound must be lower than the second. 

The user has tried to log in on a console which is already In 
use; or he has attempted to add a console to those he already 
owns. 

The user has attempted to use a console which is not logged in. 
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UNAUTHORIZED The user has attempted to log into the system with an invalid 

ACCOUNT account number or name. 

FULL This message may appear on an attempt to log into TSS/8 from 

a console. It means that all disk swapping tracks are in use. 

CI HAS SI Job CI had device SI; the request for its acquisition cannot be 

granted. 

CI = job number 
S 1 = device name 
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APPENDIX A 
TSS/8 CHARACTER SET 

TSS/8 accept°s S-bif ASCII characfer only. ASCII is an abbreviation for USA Code for 
Information Interchange. The acceptable characters and their 6- and 8-bit octal equivalence are 
listed below. 





6-Bit* 


8-Bit 


Character 


Octal 


Octal 


Space 


00 


240 


! 


01 


241 


il 


02 


242 


# 


03 


243 


$ 


04 


244 


% 


05 


245 


& 


06 


246 


1 


07 


247 


( 


10 


250 


) 


n 


251 


* 


12 


252 


+ 


13 


253 


/ 


14 


254 


- 


15 


255 


• 


16 


256 


/ 


17 


257 





20 


260 


1 


21 


261 


2 


22 


262 


3 


23 


263 


4 


24 


264 


5 


25 


265 


6 


26 


266 


7 


27 


267 


8 


30 


270 


9 


31 


271 


: 


32 


272 


f 


33 


273 


< 


34 


274 


= 


35 


275 


> 


36 


276 


? 


37 


277 





6-Bit* 


8- Bit 


Character 


Octal 


Octal 


@ 


40 


300 


A 


41 


301 


B 


42 


302 


C 


43 


303 


D 


44 


304 


E 


45 


305 


F 


46 


306 


G 


47 


307 


H 


50 


310 


I 


51 


311 


J 


52 


312 


K 


53 


313 


L 


54 


314 


M 


55 


315 


N 


56 


316 


O 


57 


317 


P 


60 


320 


Q 


61 


321 


R 


62 


322 


S 


63 


323 


T 


64 


324 


U 


65 


325 


V 


66 


326 


W 


67 


327 


X 


70 


330 


Y 


71 


331 


Z 


72 


332 


[ 


73 


333 


\ 


74 


334 


] 


75 


335 


t 


76 


336 


■*- 


77 


337 



* Used to store passwords and filenames only 
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APPENDIX B 
SUMMARY OF COMMANDS 

A Monitor command is a string of characters terminated by a semicolon (;) or a carriage re- 
turn (RETURN key). Parameters to commands may be octal numbers, decimal numbers, character strings, 
or single letters. In the following summary, parameters are coded as follows: 

CI, C2, ... represent octal numbers 

Dl, D2, ... represent decimal numbers 

SI, S2, ... represent character strings 

LI, L2, ... represent single letters 



Logging In and Out 
LOGIN CI 51; 

LOGOUT; 
TIME CI; 



Console Manipulation 
ASSIGN K CI; 

SLAVE CI; 
UNSLAVECl; 
RELEASE K CI; 

Device Allocation 
ASSIGN LI; 



Request to login; 

CI = user's account number 
SI = user's password 

Request to logout; processing and console time is typed out 

Request typeout of processing time; 

CI = |ob number 
Without CI, current job is assumed; 

Before logging in and without CI, time-of-day is typed out; 
If C1=iob 0, time-of-day is typed out. 



Request console; 
K = console 
Cl= console number 

Slave an owner console; 
CI = console number 

Unslave an owned console; 
CI = console number 

Release console; 
K = console 
CI = console number 



Access device; 

LI = R for paper tape reader 
P for paper tape punch 
C for card reader 
L for line printer 
I for incremental plotter 
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Device Allocation (Cont) 



ASSIGN D CI; 



RELEASE LI; 
RELEASE K CI; 
RELEASE D CI; 



File 



OPEN CI SI C2; 

CLOSE SI; 
CREATE SI; 
RENAME CI SI; 

REDUCE CI Dl; 

EXTEND CI Dl; 

PROTECT CI C2; 



FCl; 

Control Of User Programs 
START CI; 



Access DECtape unit; 
D = DECtape 
CI = device number 

Release device; 

LI = R, P, C, L, or I, (see ASSIGN LI;) 

K = console 

D = DECtape unit 

Cl= console or DECtape number 



Establish association between internal file number and file; 
CI = internal file number 
SI = file name 
C2 = account number 

Close files; 

SI = list of internal file numbers 

Create new file; 

SI = name of new file 

Rename a file; 

CI - internal file number 
SI = new name of file 

Reduce length of file; 

CI = internal file number 

Dl = number of segments to be removed from end of file 

Extend length of file; 

CI = internal file number 

Dl = number of segments to be added to end of file 

Protect a file; 

CI = internal file number 
C2 = new file protection mask 

1 read protect against users with different project 
number 

2 write protect against users with different project 
number 

4 read protect against users with same project 

number 
10 write protect against users with same project 

number 
Or the sum of any combination 

Print out association between internal file numbers and files 
CI = internal file number 



Execute user program; 

CI = starting location 
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Control of User Programs (Cont) 



START; 



Restart user program; 



DEPOSIT CI C2...Cn; Sfore in core memory; 

CI = location 
C2 = contents to be stored 



EXAMINE CI Dl; 



Cn = location Cl+n-1 
n < 10 decimal 

List specified contents; 
CI = first location 
Dl = number of location to be listed 
Dl < 10 decimal 



Saving and Restoring Binary User Programs 



SAVE 51; 
SAVE SI CI; 
SAVE SI CI C2; 
SAVE SI CI C2 C3; 



LOAD CI SI; 
LOAD CI SI C2; 
LOAD CI SI C2 C3; 
LOAD CI SI C2 C3 C4; 



RSI; 
RUN SI; 
RUN CI SI; 

S; 
WHERE; 

USER; 

USER CI; 



Save core image; 

SI = name of file 

CI = file address of first word to be 

saved; if not specified, entire 4K is saved 
C2 = core address of first word to be saved; if not specified, 

entire core is saved 
C3 = core address of last word to be saved; if not specified, 

entire core is saved 

Load core image; 

CI = owner's account number 

SI = name of file 

C2 = file address of first word to be loaded; if not specified, 

entire 4K is loaded 
C3 = core address of first word to be loaded, if not 

specified, entire core is loaded 
C4 = core address of last word to be loaded; if not 

specified, entire core is loaded 

Run System fi le; 

SI = name of file 

Run user fi le; 

SI = name of file 

Run user file; 

CI = owner's account number 
SI = name of file 

Stop execution 

Type out contents of location counter, accumulator, link, 
and switch register 

Type out number of the job and devices owned 

Type out device numbers; 

CI = user's account number 
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Saving and Restoring Binary User Programs (ConO 



SWITCH CI; 

Switchboard 

SET LI L2 CI L3 C2; 



Set switch register; 

CI = word to be set 



Set bit in Permission or Switchboard Table; 
LI = P for Permission Table 

S for Switchboard Table 
L2 = K for keyboard 

P for user program 
CI = keyboard or program number 
L3 = I for input buffer 

O for output buffer 
C2 = receiving buffer number 



RESET LI L2 CI L3 C2; Clear bit in Permission or Switchboard Table; 

parameters are as in SET, above 



READ LI L2 CI L3 C2; 

DUPLEX; 
ALLOW CI; 

LINK CI; 



Read bit in Permission or Switchboard Table; 
parameters are as in SET, above 

Echo typed characters on printer; 

Permit console CI to output on this console; 
CI = console number 

Output to console CI; 
CI = console number 
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APPENDIX C 
SUMMARY OF lOT INSTRUCTIONS 



PROGRAM CONTROL 



6000 


SIM 


Set Interrupt Mask 


6001 


ION 


Interrupt Turn On 


6002 


lOF 


Interrupt Turn Off 


6003 


RIM 


Read Interrupt Mask 


6005 


SWM 


Set Wait Mask 


6006 


CWM 


Clear Wait Mask 


6007 


RWM 


Read Wait Mask 


6200 


CKS 


Check Status 


6402 


SLV 


Slave A Console 


6403 


UNS 


Unslave A Console 


6404 


SSP 


Set Switchboard and Permission Tables 


6410 


WAIT 


Wait 


6411 


URT 


User Run Time 


6412 


TOD 


Time Of Day 


6413 


RCR 


Return Clock Rate 


6414 


DATE 


Date 


6415 


SYN 


Quantum Synchronization 


6416 


STM 


Set Timer 


6420 


TSS 


Skip On TSS 


6421 


USE 


User 


6422 


CON 


Console 


6430 


SSW 


Set Switch Register 


6440 


ASD 


Assign Device 


6442 


REL 


Release Device 


7402 


HLT 


Halt 


7404 


OSR 


OR With Switch Register 


FILE CONTROL 






6600 


REN 


Rename File 


6601 


OPEN 


Open File 


6602 


CLOS 


Close File 


6603 


RRLE 


Read File 


6604 


PROT 


Protect File 


6605 


WFILE 


Write File 


6610 


CRF 


Create File 


6611 


EXT 


Extend File 


6612 


RED 


Reduce File 


6613 


FINF 


File Information 


6614 


SIZE 


Segment Size 


6617 


ACT 


Account Number 


6616 


WHO 


Who 
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INPUT BUFFER CONTROL 



6030 


KSR 


Read Keyboard String 


6031 


KSF 


Skip On Keyboard Flag 


6032 


KCC 


Clear Keyboard Flag 


6034 


KRS 


Read Keyboard Buffer Static 


6036 


KRB 


Read Keyboard Buffer Dynamic 


6400 


KSB 


Set Keyboard Break 


6401 


SBC 


Set Buffer Control Flags 


OUTPUT BUFFER CONTROL 




6040 


SAS 


Send A String 


6041 


TSF 


Skip On Teleprinter Flag 


6042 


TCF 


Clear Teleprinter Flag 


6044 


TPC 


Load Teleprinter and Print 


6046 


TLS 


Load Teleprinter Sequence 


HIGH-SPEED PAPER TAPE READER AND CONTROL (TYPE PC02) 


6010 


RRS 


Read Reader String 


6011 


RSF 


Skip On Reader Flag 


6012 


RRB 


Read Reader Buffer 


6014 


RFC 


Reader Fetch Character 


HIGH-SPEED PAPER TAPE PUNCH AND CONTROL (TYPE PC03) 


6020 


PST 


Punch String 


6021 


PSF 


Skip On Punch Flag 


6022 


PCF 


Clear Punch Flag 


6024 


PPC 


Load Punch Buffer and Punch Character 


6026 


PLS 


Load Punch Buffer Sequence 


DECTAPE CONTROL (TYPE TCOl) 




6764 


DTXA 


Load Status Register A 


6771 


DTSF 


Skip On Flags 


6772 


DTRB 


Read Status Register B 


AUTOMATIC LINE PRINTER AND CONTROL gVPE 645) 


6651 


LSE 


Skip On Line Printer Error 


6652 


LCB 


Clear Printer Buffer 


6654 


LLB 


Load Printer Buffer 


6661 


LSD 


Skip On Line Printer Done Flag 


6662 


LCF 


Clear Line Printer Flags 


6664 


LPR 


Clear Format Register 


INCREMENTAL PLOTTER AND CONTROL (TYPE 350B) 


6501 


PLSF 


Skip On Plotter Flag 


6502 


PLCF 


Clear Plotter Flag 


6504 


PLPU 


Pen Up 


6511 


PLPR 


Pen Right 


6512 


PLDU 


Drum Up 
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INCREMENTAL PLOTTER AND CONTROL (TYPE 350B) (Conf) 



6514 


PLDD 


Drum Down 


6521 


PLPL 


Pen Left 


6522 


PLUD 


Drum Up 


6524 


PLPD 


Pen Down 


CARD READER AND CONTROL gVPE 451) 


6630 


RCS 


Read Card String 


6632 


CRSF 


Skip On Card Reader Flag 


6634 


CERS 


Read Card Equipment Status 


6671 


CRRB 


Read Card Reader Buffer 


6672 


CRSA 


Select Alphanumeric 


6674 


CRSB 


Select Binary 
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APPENDIX D 
REQUIRED MODinCATIONS 

The PDP-8/I or PDP-8 computer must have the following KT08/I time-sharing modifications 
to be used in a TSS/8 system. 

a. USER FLAG REGISTER (UF) - UF is a 1-bit register that specified Monitor (UF=0) or 
user (UF=1) mode. In Monitor mode all instructions are legal; in user mode HALT, OSR, and lOT 
instructions are trapped via the program interrupt system. UF is cleared by the LOAD ADDress switch. 

b. SAVE FIELD REGISTER EXTENSION (SF6) - When a program interrupt occurs, this bit 
is cleared and then loaded from the UF. 

c. USER BUFFER REGISTER (UB) - The UB serves as a 1-bit input buffer for the UF. All 
transfers into the UF are made through the UB, except transfers from the computer console switches. 
The Change User Flag (CUF) instruction loads the UB with the value contained in the Memory Buffer 
(MB). The Restore Memory Field (RMF) instruction transfers the contents of SF6 into the UB to restore 
the UF to the condition that existed prior to a program interrupt. The UF is cleared by the LOAD 
ADDress switch. 

The following machine instructions have been changed to operate as indicated. 

a. Name and Mnemonic: CHANGE USER FLAG (CUF) 
Octal Codes: 6264 and 6274 

Execution Time: 1 .5 ^is 

Operation: 6264 sets the UF to 0; 6274 sets the UF to 1 . The next JMP or JMS 
instruction causes the appropriate mode to be entered. 

Symbol : MB8 - UB 

b. Name and Mnemonic: SKIP ON USER lOT (SKIOT) 
Octal Code: 6245 

Execution Time: 1.5 ^is 

Operation: HALT, OSR, and lOTs when executed with UF=1, sets the user lOT 

(UIOT) flag and, if the program interrupt is enabled, causes an interrupt. 

c. Name and Mnemonic: CLEAR USER lOT (CIOT) 
Octal Code: 6204 

Execution Time: 1 .5 ^is 

Operation: Clears the user lOT (UIOT) flag. 

Symbol: - UIOT 

d. Name and Mnemonic: READ INTERRUPT BUFFER (RIB) 
Octal Code: 6234 

Execution Time: 1.5 ^is 
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Operation: The contents of the Instruction Field, Data Field, and User Flag held in 
the Save Field Register during a program interrupt are transferred into bits 
6 through 8, 9 through 1 1 , and 5, respectively. 

Symbols: SFO-2 -AC6-8, SF3-5 -* AC9-11 , SF6 -AC5 

e. Name and Mnemonic: RESTORE MEMORY RELD (RMF) 

Octal Code: 6244 

Execution Time: 1 .5 ps 

Operation: This instruction is used upon exit from the program interrupt subroutine in 
another field. The Instruction Field, Data Field, and User Flag that were 
interrupted by the subroutine are restored by transferring the contents of 
the Save Field Register into the Instruction Buffer and Data Field Registers 
and the User Buffer. 

Symbols: SFO-2 -IB, SF3-5-DF, SF6-UB 
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APPENDIX E 
STORAGE ALLOCATION 



E.I STORAGE MAP 

A menfal ptcfure of the system's storage allocation is illustrated below. 



pop-e/i 

CORE MEMORY 



FIELD 



4K 






.r 



FIELD 1 



4K 



T~V, 



SYSTEM 

INTERPRETER 

AND 

ERROR 

PHANTOM 



4K 



FILE 
PHANTOM 



SYSTEM 
INITIAL- 
IZATION 



RESIDENT 
MONITOR 



4K 4K 

SYSTEM MONITOR " 

h- 



4K 



USER 
PROGRAMS 



4K 



-SWAPPING AREA 



• •• 



\ 



USER 
PROGRAMS 



FILE 
STORAGE 



4K 
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Figure E-1 TSS/8 Storage Map 



FILE DIRECTORIES 



There are two directories on the disk: the Master File Directory, referenced mainly by the 
system, and the User File Directory, referenced by the TSS/8 user. One of the functions of the MFD 
is to serve as a directory for the UFD. A UFD is a particular user's own file directory and will contain 
the names of programs he has created on the disk. 

The UFD itself is a file like any other file except that its filename is a binary number in 
combination with a four-letter password. The leftmost seven bits of the binary combination are used 
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for the project number, and the remaining five bits are used for the programmer number. When a user 
is logged in under a specific project-programmer number and references the disk, he is actually re- 
ferencing his own area through the UFD having his project-programmer number as its name. He may of 
course, specifically code his routine to reference UFD's of other users or the MFD; whether he is success- 
ful or not will depend upon the type of protection that has been specified for the area he is trying to 
reference. 

An illustration of the file directories is shown below. 





MASTER FILE 


DIRECTORY 


WORD 1 


PROJECT NO. 


PROG. NO. 1 




(1CHAR) PA 
( 1 CHAR.) WO 


SS (1CHAR.) 
RD (1 CHAR.) 




LINK TO NEXT ENTRY 




CONSOLE 




TIME 


CPU 




Tl 


ME 


WORD 8 


POINTER TO RETRIEVAL 




LINK 


TO NEXT RETRIEVAL BLOCK 




SEGMENT 


*1 




SEGMENT 


*2 




SEGMENT 


#3 




SEGMENT 


#4 




SEGMENT 


# 5 




SEGMENT 


# 6 




SEGMENT 


#7 




USER FILE 


DIRECTORY 


(1 CHAR.) Fl 
(1 CHAR.) NA 
(1 CHAR.) WO 


LE (1CHAR.) 
ME (1CHAR.) 
RD (1CHAR.) 


LINK TO NEXT ENRTY 


UNUSED 


PROTECTED BITS 


SEGMENT COUNT 


DATE OF LAST ACCESS 


POINTER TO RETRIEVAL 



LINK TO NEXT RETRIEVAL BLOCK 


SEGMENT 


# 1 


SEGMENT 


#2 


SEGMENT 


*3 


SEGMENT 


#4 


SEGMENT 


# 5 


SEGMENT 


#6 


SEGMENT 


#7 



Figure E-2 File Directories 
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